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Fencing 


e Ensure ordering between operations 
e Synchronize buffer sharing 


- e.g.: Between GPU and Display drivers 
e Allow async operations 
e Implicit fencing: userspace not aware 
e Explicit fencing: userspace aware 
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Implicit Fencing 


e No userspace knowledge/interference 
e Simple/Dumb compositors 

- No buffer state information 
e But it can freeze the whole desktop! 
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Implicit Fencing 


e Buffer C will be composed of A and B 
e Buffers A and B can render in Parallel 
e Compositor notified only when both finishes 
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Implicit Fencing 


e Ais fast and B takes too long 
e Cis blocked waiting for both to render 
e The entire desktop freezes! 
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e Fences goes to userspace 

e Userspace can control synchronization 
e Smart decisions on compositors 

e Avoid blocking the entire desktop 


COLLABORA 
CO 


Explicit Fencing 


e Consumer/Producer without blocking 
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Userspace 
pH 


execbuffer 
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e Better for traceability/debuggability 
e Vulkan needs It 


- Part of the API 
- Efficient subbuffer processing 
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Android Sync Framework 


e Android's Explicit Fencing implementation 
e Use fd for fence passing 

e Sync Timeline to control ordering 

e Sync Point to represent a fence 

e Sync Fence for fd passing 
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Sync Timeline 
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e Monotonically increasing counter 
e Usually one timeline per driver context 
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Sync Point 
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e It is the fence 
e Represents a value on the timeline 
e Three states: active, signaled and error 
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Sync Fence 
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e Wrap Sync Point into a file 
e Also have active and signaled states 
e Shared via fd-passing to/from userspace 
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e Sync fences can be merged! 
e It can contain many Sync Points 
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Android Sync Framework - ioctls 


e sync walt(fd, timeout) 
e fd3 = sync merge(fd1, fd2) 
e sync fence info(fd, info) 
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Mainline Explicit Fencing 


e Started with the fence synchronization 
mechanism by Maarten Lankhorst 
e Buffer synchronization between drivers 
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struct fence 


e fence->context 

e fence signal() 

e fence wait() 

e fence add callback() 
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Sync Framework de-staging 


e Android Sync added to staging in 2013 
e Mainly need for fd-passing 

e Removed Sync Timeline 

e Removed Sync Point 

e Reworked Sync Fence 
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Sync File 


Renamed Sync Fence to Sync File 
Changed ioctl API 


- Provided patch to Android's libsync 
Removed internal kernel API 
Used strictly for fd-passing 


- sync file = sync file create(fence) 
- fence = sync file get fence(fd) 
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struct fence array 


e Subclass of struct fence 

e Store multiple fences 

e Useful for merged Sync File 

e Hide complexity from the drivers 
e fence is array(fence) 
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DRM/KMS 


e Only available for Atomic Modesetting 
e Entirely in DRM Core 

e Extended Atomic IOCTL 

e in-fences: received from userspace 

e out-fences: sent to userspace 
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DRM/KMS: in-fences 


e in-fences: fences received from userspace 

e FENCE FD property on each DRM Plane 

e Receives sync file fds carrying fences 

e drm atomic helper wait for fences() helper 
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DRM/KMS: out-fences 


e One out-fence per DRM CRTC 


e get unused fd() + sync_file_create() + 
fd install() 
e It signals at CRTC scanout 
- It means the previous buffer can be reused. 
e Userspace need to ask for out-fence 
- DRM MODE ATOMIC OUT FENCE flag 
- libdrm: drmModeAtomicAddOutFences() 
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DRM/renderer 


e Similar to KMS side 
e Extends execbuffer ioctl args on each driver 


e Every driver needs sync file/fences support 
e WIP on freedreno, 1915 and virg] 
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Mesa 


e EGL ANDROID native fence sync 
- Create fence fd 
e EGL ANDROID wait sync 


- Make the GPU walt for fence to signal 
e WIP by Rob Clark 
e kmscube running on explicit fencing 
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drm hwcomposer2 


e Already support DRM fences semantic 
e Use itas example userspace for upstream 
e WIP by Sean Paul and Robert Foss 
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Current Status Summary 


Sync File syncronization de-stage: DONE 
SW SYNC validation de-stage: DONE 
fence array: DONE 

DRM/KMS: WIP - 4.10? 

DRM/renderer: WIP - 4.10? 

MESA: WIP 

igt-gpu-tools: WIP 

drm hwcomposer2: WIP 

Wayland: TODO 

e VAL explicit fences: TODO 
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